Resource URL: /platform/<<version=3>>/fsa/results/<ID>/histogram/<STAT>/by/<BREAKOUT>

    Overview: Retrieve a breakout of the STAT histogram according to BREAKOUT
              parameter.

     Methods: GET

********************************************************************************

Method GET: This resource retrieves a histogram breakout for an individual FSA
            result set. ID in the resource path is the result set ID.

       URL: GET
            /platform/<<version=3>>/fsa/results/<ID>/histogram/<STAT>/by/<BREAKOUT>

Query arguments:
 directory_filter=<string> Filter according to a specific directory, which
                           includes all of its subdirectories.
 attribute_filter=<string> Filter according to the name of a file user
                           attribute.
 node_pool_filter=<string> Filter according to the name of a node pool, which
                           is a set of disk pools that belong to nodes of the
                           same equivalence class.
 disk_pool_filter=<string> Filter according to the name of a disk pool, which
                           is a set of drives that represent an independent
                           failure domain.
      tier_filter=<string> Filter according to the name of a storage tier,
                           which is a user-created set of node pools.
     comp_report=<integer> Result set identifier for comparison of database
                           results.
 log_size_filter=<integer> Filter according to file logical size, where the
                           filter value specifies the lower bound in bytes to a
                           set of files that have been grouped by logical size.
                           The list of valid log_size filter values may be
                           found by performing a histogram breakout by log_size
                           and viewing the resulting key values.
phys_size_filter=<integer> Filter according to file physical size, where the
                           filter value specifies the lower bound in bytes to a
                           set of files that have been grouped by physical
                           size. The list of valid phys_size filter values may
                           be found by performing a histogram breakout by
                           phys_size and viewing the resulting key values.
           limit=<integer> Limit the number of breakout results.
  path_ext_filter=<string> Filter according to the name of a single file
                           extension.
    ctime_filter=<integer> Filter according to file modified time, where the
                           filter value specifies a negative number of seconds
                           representing a time before the begin time of the
                           report. The list of valid ctime filter values may be
                           found by performing a histogram breakout by ctime
                           and viewing the resulting key values.
    atime_filter=<integer> Filter according to file accessed time, where the
                           filter value specifies a negative number of seconds
                           representing a time before the begin time of the
                           report. The list of valid atime filter values may be
                           found by performing a histogram breakout by atime
                           and viewing the resulting key values.

GET response body schema:
{
  "type": "object", 
  "properties": {
    "result_length": {
      "required": true, 
      "type": "integer", 
      "description": "Total length of the result list."
    }, 
    "breakouts": {
      "items": {
        "type": "object", 
        "properties": {
          "data": {
            "required": true, 
            "type": "array", 
            "description": "List of bucket, file count pairs.", 
            "properties": {
              "bucket": {
                "required": true, 
                "type": "integer", 
                "description": "Stat histogram bucket."
              }, 
              "value": {
                "required": true, 
                "type": "integer", 
                "description": "Number of files in bucket."
              }
            }
          }, 
          "key": {
            "required": true, 
            "type": "string", 
            "description": "Breakout key by which results are filtered."
          }
        }
      }, 
      "required": true, 
      "type": "array", 
      "description": "Histogram breakout data according to breakout parameter."
    }, 
    "begin_time": {
      "required": true, 
      "type": "integer", 
      "description": "Unix Epoch time of start of results collection job."
    }
  }
}
